home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / mus / play / SPlayLib31.lha / superplay-lib / Docs / SPObject-Docs / WAV.doc < prev    next >
Text File  |  1994-07-21  |  4KB  |  120 lines
  1.  
  2.   WAV.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 1.4
  9.   Release Date : 19.06.1994
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   WAV.svobject is an external Library-Module for the superplay.library V1+.
  15.  
  16.   It supports reading and writing of PC RIFF-WAVE (WAV) Sample-Files,
  17.   playing is supported as far as the Amiga is able to (8 Bit only).
  18.  
  19.  
  20.   Author
  21.   ~~~~~~
  22.   Andreas R. Kleinert
  23.   Grube Hohe Grethe 23
  24.   D-57074 Siegen
  25.   Germany
  26.  
  27.  
  28.   History :
  29.   ~~~~~~~~~
  30.   V1.4 (19.06.1994) :
  31.  
  32.    - version still reflected 1.2 instead 1.3. Now we're at 1.4 :-)
  33.    - changed way of reading the WAV-Header, so that files with
  34.      extended Headers (don't know if there are such files) might be
  35.      read as well in the future, while files with shortened header
  36.      (possibly corrupted) will no longer be accepted (they would be
  37.      interpreted wrong, anyway).
  38.    - made some WORDs to UWORDs
  39.    - fixed possible bug-source (memory)
  40.  
  41.  
  42.   V1.3 (29.04.1994) :
  43.  
  44.    - fixed (hopefully) "header not located" problems within memory
  45.      delocation
  46.    - also fixed AllocMem()/FreeVec() conflict with SampleData-Buffer
  47.  
  48.  
  49.   V1.2 (31.03.1994) :
  50.  
  51.    You should consider V1.1 to be a _BAD_ BETA-Version now, because :
  52.  
  53.    - as soon as I got some original (not converted) WAV-Files, I found
  54.      out, that V1.1 was more or less UN-USEABLE, because it was so
  55.      BUGGY ;<
  56.    - IntelToMotorola (and reverse) conversion was not correct for
  57.      LONGwords, which concerned :
  58.  
  59.       - ChunkSize           (File Header : FileSize)
  60.       - SubSize             (Fmt  Chunk  : Chunk Size)
  61.       - SamplesPerSec       (Fmt  Chunk  : Frequency)
  62.       - BytesPerSec         (Fmt  Chunk  : Frequency, stereo)
  63.       - DataSize            (Data Chunk  : Chunk Size)
  64.  
  65.      If you were "lucky", this might have meant, that the samples would
  66.      have been played too short and with the wrong frequency ;)
  67.      If you were "unlucky", they would not have been played at all !
  68.  
  69.      Due to these bugs, only self-written WAV-Files were replayed
  70.      correctly, because they were WRITTEN AS WRONG as they have been read.
  71.    - The Fmt-Header ID was written as "FMT " instead of "fmt ", so that
  72.      perhaps not all other programs might accept files written with the
  73.      old V1.1-WAV.spobject.
  74.      Nevertheless you may recover your self-created WAV-Files by passing
  75.      them through the Freeware-Tool SoundZAP V2.3 (Fish-Disk 646), which
  76.      accepts them obviously (only the frequency might be wrong).
  77.  
  78.    - Now the positive things :
  79.  
  80.      - with this version not only the File Header, but also the single Chunks
  81.        are now checked for their correct IDs : - "WAVE","RIFF" (Header)
  82.                                                - "fmt "        (Fmt-Chunk)
  83.                                                - "data"        (Data-Chunk)
  84.      - since this version also a length of the Fmt-Chunk greater than
  85.        16 Bytes will be handled correctly : this definitely will not happen
  86.        at the time, but may happen with future expansions of the RIFF-WAVE-
  87.        Format
  88.      - the Longword-Conversion now works ;)
  89.      - now testing with "real" WAV-Files has been done :
  90.        there's a high probability now, that all WAV-Files - assuming that
  91.        they actually fit into your Chip Memory ;) - will be played in the
  92.        right way
  93.      - now there's more information given about the loaded Sample :
  94.        This information will even be available, even if there's not enough
  95.        memory to store the actual sample-data (e.g. more than 2 MByte
  96.        sample data against 1 MByte free Chip Memory)
  97.      - and more
  98.  
  99.  
  100.   V1.1 (30.03.1994) :
  101.  
  102.    - we use RawDoFmt()-based sprintf()-routine, instead of SAS/C's.
  103.      This saves about 1800 Bytes.
  104.    - "utility.library" is not used, because this crashes the Player-Task
  105.      and no reason for this could be found.
  106.    - first version
  107.  
  108.  
  109.   Literature
  110.   ~~~~~~~~~~
  111.   [1] "c't", Magazin für Computertechnik, Issue 1/1993, DMV-Verlag
  112.  
  113.  
  114.   Copyrights
  115.   ~~~~~~~~~~
  116.   Some of the mentioned names or products above may be copyrighted by
  117.   companies or trademarks of companies.
  118.  
  119.  
  120.